home *** CD-ROM | disk | FTP | other *** search
/ Atari Forever 3 / Atari Forever 3 / Atari Forever 3.iso / PD_NEU / INTERNET / CAB / DOC / PROGRAMI / CAB_PROT.FR < prev    next >
Encoding:
Text File  |  1996-09-26  |  6.4 KB  |  267 lines
  1. Le protocole CAB
  2. ================
  3.  
  4. Le protocole CAB constitue un ensemble de messages AES qui peuvent
  5. être utilisés par des programmes GEM pour transférer des informations
  6. spécifiques à CAB. CAB prends en charge la coordination de ces
  7. opérations.
  8. Une application possible:
  9. Si une information ou une mise à jour est disponible sur Internet, le
  10. protocole CAB peut être utilisé pour accéder à cette information.
  11. CAB peut alors charger et afficher la donnée.
  12.  
  13.  
  14. Description des messages
  15. ========================
  16.  
  17. CAB_HELLO ($CAB8) (message de CAB)
  18. -----------------
  19. Après son lancement, CAB envoie le message suivant à tous les
  20. programmes en exécution :
  21.  
  22. msg[0] = $CAB8
  23. msg[1] = CAB ID
  24. msg[2] = 0
  25. msg[3] = Version du protole CAB (ou par exemple $0100 = v1.00)
  26. msg[4] = Vecteur binaire contenant les protocoles supportés (CAB.OVL)
  27.           Bit 0: HTTP
  28.           Bit 1: FTP
  29.           Bit 2: GOPHER
  30.           Bit 3: WAIS
  31.           Bit 4: MAILTO
  32.           Bit 5: NNTP
  33.           Bit 6: TELNET
  34.           Bit 7-15: 0 (reservés)
  35. msg[5] = Vecteur binaire contenant les messages du protocole CAB
  36.          pris en charge :
  37.           Bit 0: CAB_VIEW
  38.           Bit 1: CAB_MAIL, CAB_MAILSEND
  39.           Bit 2: CAB_REQUESTSTATUS, CAB_RELEASESTATUS, CAB_STATUS,
  40.                  CAB_EXIT
  41.           Bit 3-15: 0 (reservés)
  42. msg[6] = 0
  43. msg[7] = 0
  44.  
  45.  
  46.  
  47. CAB_SUPPORT ($CABB) (message vers CAB)
  48. -------------------
  49. Si CAB reçoit ce message, il réponds en envoyant un message CAB_HELLO.
  50. Si aucun message CAB_HELLO n'est reçu, la version de CAB est
  51. antérieure à l'implémentation du protocole CAB.
  52. N'importe quel programme demande l'information fournie par les
  53. messages CAB_HELLO doit envoyer, après son démarrage, un message
  54. CAB_SUPPORT à CAB. Si CAB est démarré plus tard, il enverra
  55. automatiquement un message CAB_HELLO au programme.
  56.  
  57. msg[0] = $CABB
  58. msg[1] = ID des PRGs
  59. msg[2] = 0
  60. msg[3] = 0
  61. msg[4] = 0
  62. msg[5] = 0
  63. msg[6] = 0
  64. msg[7] = 0
  65.  
  66. CAB_VIEW ($CAB3) (message vers CAB)
  67. ----------------
  68. Identique à VA_START mais les URLs sont envoyées en lieu et place des
  69. noms de fichier et CAB afiches le fichier correspondant.
  70.  
  71. msg[0] = $CAB3
  72. msg[1] = ID des PRGs
  73. msg[2] = 0
  74. msg[3] = \ Pointeur vers l'URL
  75. msg[4] = /
  76. msg[5] = 1 = CAB affiche l'URL dans une nouvelle fenêtre
  77.          0 = CAB affiche l'URL dans la fenêtre active
  78. msg[6] = 0
  79. msg[7] = 0
  80.  
  81.  
  82.  
  83. CAB_REQUESTSTATUS ($CAB5) (message vers CAB)
  84. -------------------------
  85. Peut-être envoyé vers CAB afin de déterminer si CAB est actuellement
  86. en ligne ou pas. CAB renvoie en réponse le message CAB_STATUS et
  87. après tout changement de son état de connexion.
  88.  
  89. msg[0] = $CAB5
  90. msg[1] = ID des PRGs
  91. msg[2] = 0
  92. msg[3] = 0
  93. msg[4] = 0
  94. msg[5] = 0
  95. msg[6] = 0
  96. msg[7] = 0
  97.  
  98.  
  99.  
  100. CAB_RELEASESTATUS ($CAB7) (message vers CAB)
  101. -------------------------
  102. Un programme doit envoyé ce message vers CAB si il ne veux plus
  103. recevoir l'état de connexion de CAB qu'il peut demander par
  104. l'intermédiaire du message CAB_REQUESTSTATUS (par ex. : Si
  105. le programme va être quitté).
  106.  
  107. msg[0] = $CAB7
  108. msg[1] = ID des PRGs
  109. msg[2] = 0
  110. msg[3] = 0
  111. msg[4] = 0
  112. msg[5] = 0
  113. msg[6] = 0
  114. msg[7] = 0
  115.  
  116.  
  117.  
  118. CAB_STATUS ($CAB6) (message from CAB)
  119. ------------------
  120. CAB envoies ce message à tous les programmes qui ont demandé à être
  121. tenu informé de l'état de connexion de CAB par le message
  122. CAB_REQUESTSTATUS.
  123.  
  124. msg[0] = $CAB6
  125. msg[1] = CAB ID
  126. msg[2] = 0
  127. msg[3] = 1 = CAB on-line
  128.          0 = CAB off-line
  129. msg[4] = 0
  130. msg[5] = 0
  131. msg[6] = 0
  132. msg[7] = 0
  133.  
  134.  
  135.  
  136. CAB_EXIT ($CAB1) (message from CAB)
  137. ----------------
  138. CAB envoies ce message à tous les programmes qui ont demandé à être
  139. tenu informé de l'état de connexion de CAB par le message
  140. CAB_REQUESTSTATUS puis CAB est quitté. CAB envoi au préalable le
  141. message CAB_STATUS à tous les programems pour leur indiqué qu'il est
  142. à l'état hors ligne (off-line).
  143.  
  144. msg[0] = $CAB1
  145. msg[1] = CAB ID
  146. msg[2] = 0
  147. msg[3] = 0
  148. msg[4] = 0
  149. msg[5] = 0
  150. msg[6] = 0
  151. msg[7] = 0
  152.  
  153. CAB_MAIL ($CAB9) (message vers CAB)
  154. ----------------
  155. Peut-ête envoyé à CAB pour l'envoi d'un mail.
  156.  
  157. msg[0] = $CAB9
  158. msg[1] = ID of the PRGs
  159. msg[2] = 0
  160.  
  161. msg[3] = \ Pointeur vers une URL. Une ligne de sujet peut être ajoutée
  162.            à l'URL en utilisant un point d'interrogation comme
  163. msg[4] = / séparateur.
  164.  
  165. msg[5] = \ Pointeur vers un fichier qui contient le message de mail
  166. msg[6] = / ou null, dans ce cas, CAB ouvre l'éditeur pour la saisie
  167.            du message.
  168.  
  169. msg[7] = Bit vector:
  170.           Bit 0: 0 = Envoi du mail immédiatement
  171.                  1 = Le message de Mail peut-être pris en charge et
  172.                      ou édité par CAB.
  173.           Bit 1: Le fichier doit être supprimer par CAB après son
  174.                  traitement.
  175.           Bil 2-15: reservés (0)
  176.  
  177. CAB_MAILSENT ($CABA) (message de CAB)
  178. --------------------
  179. CAB envoie ce message en réponse au message CAB_MAIL pour informer le
  180. programme si le message a été envoyé avec un indicateur d'état.
  181.  
  182. msg[0] = $CABA
  183. msg[1] = CAB ID
  184. msg[2] = 0
  185. msg[3] = 1 = Mail envoyé sans erreur/s
  186.          0 = Une erreur s'est produite, msg [4] indique la nature de
  187.              l'erreur
  188. msg[4] = Retourne le numéro de l'erreur, si msg[3] = 0
  189.        = 0: Pas d'URL indiquéen.
  190.        = 1: Off-line, la connexion réseau a été perturbée, le serveur
  191.             n'était pas accessible
  192.        = 2: L'utilisateur a annulé l'envoi du mail (c'est-à-dire
  193.             que le mail était géré par CAB et donc que l'utilisateur
  194.             a eu cette oportunité
  195.        = 3: Erreur GEMDOS lors de l'accès au fichier de message
  196.        = 4: L'éditeur de mail ne peut pas être trouvé
  197. msg[5] = 0
  198. msg[6] = 0
  199. msg[7] = 0
  200.  
  201.  
  202.  
  203.  
  204. Messages spéciaux pour 'Outils de Cache'
  205. ========================================
  206.  
  207. CAB_CCHANGED ($CAB0) (message de et vers CAB)
  208. --------------------
  209. Le cache (c'est-à-dire CACHE.CAB) a été modifié et doit être relu.
  210.  
  211. msg[0] = $CAB0
  212. msg[1] = CAB ID/ID des PRGs
  213. msg[2] = 0
  214. msg[3] = 0
  215. msg[4] = 0
  216. msg[5] = 0
  217. msg[6] = 0
  218. msg[7]
  219.  0
  220.  
  221.  
  222.  
  223. CAB_EXIT ($CAB1) (message de et vers CAB)
  224. ----------------
  225. CAB ou Cache-Tool a été quittés (chaque PRG doit informer l'autre
  226. lorsqu'il est quitté).
  227.  
  228. msg[0] = $CAB1
  229. msg[1] = CAB ID/ID des PRGs
  230. msg[2] = 0
  231. msg[3] = 0
  232. msg[4] = 0
  233. msg[5] = 0
  234. msg[6] = 0
  235. msg[7] = 0
  236.  
  237.  
  238.  
  239. CAB_PATH ($CAB2) (message de CAB)
  240. ----------------
  241. Les répertoires HTML et/ou de cache ont été modifiés. Pour plus de
  242. détails, référez vous à la documentation de 'outil de cache'.
  243.  
  244. msg[0] = $CAB2
  245. msg[1] = CAB ID
  246. msg[2] = 0
  247. msg[3] = 0
  248. msg[4] = 0
  249. msg[5] = 0
  250. msg[6] = 0
  251. msg[7] = 0
  252.  
  253.  
  254.  
  255. CAB_TERM ($CAB4) (message de CAB)
  256. ----------------
  257. L'outil de Cache doit s'arréter.
  258.  
  259. msg[0] = $CAB4
  260. msg[1] = CAB ID
  261. msg[2] = 0
  262. msg[3] = 0
  263. msg[4] = 0
  264. msg[5] = 0
  265. msg[6] = 0
  266. msg[7] = 0
  267.